home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / clk251.zip / CLK.DOC < prev    next >
Text File  |  1993-03-20  |  14KB  |  344 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             
  20.                             
  21.                             
  22.                             
  23.                             
  24.                             STEENBURGH'S STUFF
  25.                           Mildly Useful Utilities
  26.                               For Batch Files
  27.                                Version  2.51
  28.           Copyright 1991-1993 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                             _______
  31.                        ____|__     |               (TM)
  32.                     --|       |    |-------------------
  33.                       |   ____|__  |  Association of
  34.                       |  |       |_|  Shareware
  35.                       |__|   o   |    Professionals
  36.                     -----|   |   |---------------------
  37.                          |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         CLK 2.5                                                         |
  69.         Copyright 1991-1993 by Chuck Steenburgh & Tay-Jee Software
  70.         
  71.            DOS offers the TIME and DATE commands which allow to   
  72.         display, then set, the time and date.  Unfortunately,     
  73.         these commands "hang up" your system in that they prompt  
  74.         you for a new time and/or date when entered by themselves 
  75.         on the command line.  CLK allows you to display the time  
  76.         and date and then immediately terminate.                  
  77.         
  78.         Usage:     CLK [/T] [/W] [/M] [/D] [/C] [/Rnn] [/Lnn] [nnn] [/E]|
  79.                or  CLK "Format" [/C] [/Rnn] [/Lnn] [nnn] [/E]           |
  80.         
  81.                   /T             displays the time in 24-hour 
  82.                                  format                       
  83.                                  
  84.                   /W             displays three-letter abbreviation 
  85.                                  for the day of the week            
  86.                                 
  87.                   /M             displays three-letter abbreviation 
  88.                                  for the month                      
  89.                                  
  90.                   /D             displays the date
  91.                   
  92.                   /C             centers the displayed string on the
  93.                                  current line.
  94.                                  
  95.                   /Rnn           displays string on row nn, where nn is 
  96.                                  a number between 0 and 24.             
  97.                                  
  98.                   /Lnn           displays string starting in column nn, 
  99.                                  where nn is a number between 0 and 79. 
  100.                                  
  101.                   nnn            displays output in color nnn, where nnn
  102.                                  is a number between 0 and 255.  See    
  103.                                  Appendix 3 for color information.
  104.                   
  105.                   /E             set result to environment variable CLK |
  106.                                  
  107.                   "Format"       displays special time elements as part 
  108.                                  of a formatted string.  Must be enclos-
  109.                                  ed in quotes.  See below for details.  
  110.                                                                         
  111.         Examples: (assuming run at 11:45am Sunday 6 October 1991)      
  112.                                  
  113.              CLK                 displays the current time and date in 
  114.                                  the form: Sun Oct 06 11:45:00 1991    
  115.                                  
  116.              CLK /t              displays time: 11:45:00               
  117.              
  118.              CLK /w              displays day of the week: Sun         
  119.              
  120.              CLK /m              displays month: Oct                   
  121.              
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.              CLK /d              displays date: 06                     
  130.              
  131.              CLK /t /m /d /w     displays: 11:45:00 Sun Oct 06         
  132.              
  133.              CLK /c /w /t        displays: 11:45:00 Sun (centered on
  134.                                  current line)                      
  135.                                  
  136.              CLK /c /t /r10 79   displays 11:45:00 centered on line 10  
  137.                                  in bright white on a red background    
  138.                                  
  139.              CLK "Time: 0"      displays: Time: 11:45:00
  140.              
  141.              CLK /t /e           displays 11:45:00, sets environment    |
  142.                                  variable CLK equal to the string       |
  143.                                  "11:45:00"                             |
  144.              
  145.            Command-line parameters may be entered in any order.  Dif- 
  146.         ferent elements of the date/time, however, will always be dis-
  147.         played in the following order: time, day of the week, month,  
  148.         and date.
  149.         
  150.            The format string combines text with special replaceable     
  151.         parameters to produce customized output.  The text, which       
  152.         should be enclosed in quotes, can be a message which includes   
  153.         elements of the time.  Use replaceable parameters, prefixed by  
  154.         the percent () sign, to represent the following data:          
  155.         
  156.            a   Abbreviated weekday (i.e., Sun, Mon, etc.)              
  157.            A   Full weekday                                            
  158.            b   Abbreviated month (i.e., Jan, Feb, etc.)                
  159.            B   Full month                                              
  160.            0   Day of the month (01-31)                                
  161.            H   Hour (24-hour clock 00-23)                              
  162.            I   Hour (12-hour clock 00-11)                              
  163.            j   Julian date (0-366)                                     
  164.            m   Month (01-12)                                           
  165.            M   Minute (00-59)                                          
  166.            0000   Meridian (am or pm)                                     
  167.            S   Second (00-59)                                          
  168.            U   Week of the year (00-52), Sundays first                 
  169.            W   Week of the year (00-52), Mondays first                 
  170.            w   Day of the week (0-6), Sunday first                     
  171.            0   Date (MM/DD/YY)                                         
  172.            0   Time (HH:MM:SS)                                         
  173.               Year (00-99)                                            
  174.            Y   Year (0000-9999)                                        
  175.            Z   Timezone                                                
  176.         
  177.            Special note:  when using CLK with a custom format string    
  178.         in a batch file, you must use the double percent sign (%) when 
  179.         prefixing the special replaceable parameters.                   
  180.         
  181.         Examples:
  182.         
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.              From the command line:
  191.              
  192.              CLK "The time is now: 0.  You have thirty minutes."
  193.              
  194.              produces the string:
  195.              
  196.              The time is now: 11:45:00.  You have thirty minutes.
  197.              
  198.              
  199.              From a batch file:
  200.              
  201.              CLK "Today is %d %B, %Y."
  202.              
  203.              produces the string:
  204.              
  205.              Today is 06 October, 1991.
  206.         
  207.            For additional options in setting elements of the time to an |
  208.         environment variable, see the program WHENISIT (also part of    |
  209.         STEENBURGH's STUFF.                                             |
  210.                                                                                                                                                                                                  
  211.         
  212.         
  213.         OMBUDSMAN
  214.         
  215.           This program is produced by a member of the Association of
  216.         Shareware Professionals (ASP).  ASP wants to make sure that
  217.         the shareware principle works for you.  If you are unable to
  218.         resolve a shareware-related problem with an ASP member by
  219.         contacting the member directly, ASP may be able to help.  The
  220.         ASP Ombudsman can help you resolve a dispute or problem with
  221.  
  222.                                      Page 4
  223.  
  224.  
  225.  
  226.  
  227.  
  228.         an ASP member, but does not provide technical support for 
  229.         members' products.  Please write to the ASP Ombudsman at 545
  230.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  231.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  232.         
  233.         
  234.         DISCLAIMER
  235.         
  236.            The programs described in this documentation are guaran-
  237.         teed to do absolutely nothing!  They have, however, in my exper-
  238.         ience performed essentially as described herein.  The author
  239.         will not be responsible for any loss or damages caused through
  240.         the use of these programs.  No warranty, express or implied,
  241.         is provided for this software's performance, merchantability,
  242.         or fitness for a particular purpose.
  243.         
  244.            All trademarks are property of their respective owners.
  245.         
  246.            The programs and documentation are Copyright 1991,1992 by 
  247.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  248.         grams provided the following conditions are met:
  249.         
  250.            - all files contained in the archive or distribution disk
  251.              must be distributed together in UNMODIFIED form
  252.         
  253.            - you charge no more than a reasonable fee for copying or
  254.              subscription, and clearly indicate that payment of such
  255.              a fee does NOT grant ownership of the programs.
  256.         
  257.            This program is part of set of utilities known as STEEN-
  258.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  259.         utilities includes the following programs:
  260.         
  261.              BATBOX:     Simple menu creation/input system
  262.              CHKDRV:     Checks disk drive status
  263.              CHKPRN:     Checks parallel printer status
  264.              CLK:        Displays time on screen
  265.              CURSOR:     Change cursor shape
  266.              DOSVER:     Checks for DOS version currently running
  267.              INPUT:      Simple prompt/input system
  268.              KLS:        Colorful screen-clearing utility
  269.              LAUNCHER:   File selection/execution system
  270.              MUSIC:      Plays transcribed sheet music on the PC
  271.              RAND:       Random number generator
  272.              SKIP:       Prints blank lines from batch files
  273.              SOUNDER:    Wide range of noise making options
  274.              SPACE:      File/disk space reporting utility
  275.              WAITFOR:    Timed pauses 
  276.              WHENISIT:   Date/time telling utility
  277.              WRITE:      Colorful output anywhere on screen
  278.              XD:         Create/switch directories at the same time
  279.         
  280.            You may evaluate these programs for up to 30 days on a free
  281.         trial basis.  After 30 days, you should register your use of
  282.  
  283.                                      Page 5
  284.  
  285.  
  286.  
  287.  
  288.  
  289.         these programs.  The registration fee is $20, payable to the
  290.         author at the address given below.  For those registering
  291.         directly with Tay-Jee Software, we offer a $5 cash discount.
  292.         
  293.            Let's be real: I don't plan to make a lot of money this way.
  294.         Registration does have its advantages:
  295.         
  296.            - I am improving these programs all the time.  Registration
  297.              will get you IMMEDIATELY a disk with the latest version.
  298.              You will also get the next major release of the program set
  299.              sent to you free of charge.
  300.         
  301.            - While I can't promise to include everyone's suggestions
  302.              in program updates, you can bet I'll listen to registered
  303.              users before any of you scrounges out there.
  304.         
  305.            - You will make me feel all warm and fuzzy and appreciated, 
  306.              and all that good stuff.
  307.         
  308.            - You will also get an evaluation copy of my text file for-
  309.              matting program (used to produce the margins in this doc-
  310.              ument), and any other electronic creations I have decided
  311.              to unleash on a foolish, unsuspecting world.
  312.         
  313.            Send comments/registrations to:
  314.         
  315.                 Tay-Jee Software
  316.                 Post Office Box 835
  317.                 Lexington, VA 24450
  318.                 (703)464-5290
  319.                 
  320.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  321.         
  322.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  323.         
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.                                      Page 6